home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Gold Medal Software 5
/
Gold Medal Software - Volume 5 (Gold Medal) (1995).iso
/
menuts
/
e4dv204.arj
/
E4.DOC
< prev
next >
Wrap
Text File
|
1994-10-20
|
21KB
|
544 lines
****************************************************************
E4(tm) Editor (C) Copyright N.Faulks 1994. All Rights Reserved.
****************************************************************
Version 2.04 October 1994
****************************************************************
Note that this file is an E4 outline document (as well as a
printable text file), to view it in outline form from within E4,
press ALT-H, then Y for "Yes". Now you can press ALT-H over
headings or text you would like to open or close.
If you want to print this file please note that it contains some
TAB characters. To convert it to a printable (tab-less) file
type "E4 E4.DOC" then press ALT-P for print, type a filename and
press RETURN. (or press RETURN to print straight to PRN). To
leave E4 press ALT-Q.
INTRODUCTION ***************************************************
E4 is a powerful multi-file text editor with outlining,
macros, SVGA support, and in-editor compilation and
error tracking.
E4 isn't a bloated every-feature-under-the-sun product,
rather it is a small, fast editor that manages to
provide most of the features most people use.
E4 is great for people who only want to edit
AUTOEXEC.BAT and CONFIG.SYS as well as Programmers and
System/Network Adminstrators.
E4 is a complete Program Development Environment. You
can compile from within the editor, a single file or a
whole project. You can also run your program from within
the editor, with or without a debugger. E4 can shrink in
size to only 2K, leaving plenty of memory free for your
program. The registered version of E4 comes with a
program to trap error messages from a wide range of
compilers. You can then step through compilation errors
one by one, the cursor is taken to the erroneous line
and the error message is displayed at the bottom of the
screen. This works across different source files and for
most languages (mixed languages are supported), even
some linker errors are tracked to the original source
file. E4 provides a common development environment,
which ever language you are using.
E4 really is better than other editors, because it is
easy to use and powerful. Yes, you have to take the
trouble to learn it, but once you have got over the
short initial learning curve it WILL make you more
productive. Easy to use doesn't have to mean pull down
menus and WIMPs. E4 works well with a mouse, but the
common commands are only a single mnemonic keystroke (E4
doesn't use the function keys: how can they be easy to
remember?). It doesn't matter if you have "every
feature" if they are all equally difficult to use. E4
makes everyone into an expert: the "Hintline" shows you
most of the commands or options available, at every
point in the editor. Full context-sensitive help makes
E4 easy to learn.
E4 is available as two versions: E4 and E4-Deluxe. The
Deluxe version is distributed in an archive file that
begins E4D. E4-Deluxe includes user-definable pull-down
menus, and the shareware distribution includes more
sample files.
Feature lists are not the whole story: that's why E4 is
made available on a try-before-you buy basis. Don't just
reject it because it isn't exactly the same as what
you're using: try it!
E4 already has a large user community including
professional programmers, businesspeople, educators, and
students. If you've got a suggestion or problem call the
author (Neil Faulks) on 071 873 2007 (+44 71 873 2007)
anytime, or mail him on the Internet
(neil@dcs.kcl.ac.uk) or through CompuServe 100417,1251
I want you to be happy with E4, before and after you buy
it.
IMPORTANT NOTICE ***********************************************
This is a Try-before-you-buy Evaluation copy of the E4
Editor, it is fully functional. You may use E4 freely
for up to 30 days, but if you want to use it after this
period you must pay for it. See later in this file.
Occasionally the editor will ask you to press a key when
you first run it, this feature is absent from the
version you will receive upon payment.
Buying your own copy also brings the benefits of
comprehensive printed documentation, extra utility
programs and macros, and special offers on upgrades and
other products.
Programmers should note that only the registered version
supports compiler error message tracking, as it requires
extra support programs.
PACKING LIST & RELEASE NOTES ***********************************
This software should be distributed as the single .ZIP
or .EXE archive. The archive contains the files listed
below. PLEASE KEEP THE ORIGINAL ARCHIVE FILE TO GIVE TO
OTHERS.
Note that if this is the E4-Deluxe distribution more
files are included than are listed here.
E4.EXE The Editor itself (All you really need!)
E4.HLP The help file for the editor
E4KEYS A sample keyboard mapping file
E4.DOC This document, Please read it all
ORDER.DOC Printable order form and prices
HELPME.DOC Help me to help you
FILE_ID.DIZ A BBS description file
TEMPLATE.C Sample template file for C programs
E4OPTS.C Sample options file for C programs
COMPILE.EXE A generic compiler control program
COMPILE.DOC Documentation for COMPILE
COMPILE.CL Configuration file for COMPILE
The sample E4KEYS file includes some key definitions of
use only to programmers, to handle in-editor
compilation. These are distributed as macros in the
registered version, but are included here in the keys
file to save space. The sample definitions allow you to
compile from within the editor (a single file or a
complete project), and to execute your program with or
without a debugger. The registered version provides full
error tracking, allowing you to step through error
messages one by one, taking you to the correct file and
line.
Programmers should examine the E4KEYS file to learn
about creating macros to compile and debug programs.
CHANGES ********************************************************
Only major changes are listed, numerous minor changes
are made with every release. The registered version has
more detailed information.
Version 2.04
Shareware banner fixed. Presentation changed,
order form now includes other products. Dos
command now detects common DOS commands.
Untitled buffers now get default options.
Version 2.03
The top menu bar is now hidden until the menu
key is pressed or the mouse is moved over it
(E4D). Setting a default extension now disables
the "Create Project File" prompt.
Version 2.02
E4PATH enhanced so that * (meaning the current
E4.EXE directory) can appear within a pathname.
Default E4PATH changed to prefer placing config
info into a CONFIG directory if one exists.
Network users can as always have their own local
config if the HOME environment variable is set.
Added support in COMPILE.CL (shareware) and
E4TRAP (registered version) for Procomm ASPECT
language.
Version 2.01
Minor changes to documentation. Inclusion of a
DESCRIPT.ION file for 4DOS and V1 users. No
changes to programs, other than date and
version.
Version 2.0
Rectangular Box Marking. Command line selectable
keymaps. Paste chars from ASCII chart. Select
video rows from command line. 2-Key assignments.
View control chars as symbols or letters.
Enhanced exploding macros. Enhanced marking
mode, menu and display, with measurement
capability. Roaming Cursor (RC) mode to allow
cursor to move freely around screen. Shift
marking on more keys.
Version 1.6
Outlining. XMS swapping (leaving <2K resident).
Colour Brackets. LOOP, ENDLOOP and STOP in
macros. Support for Read-only buffers
(independent of Read-only files).
Version 1.51
New Ditto function using ALT-Space Bar. New
CATCH macro keyword (useful in template macros).
Enhanced handling of Read-Only files, can now
edit System and Hidden files also. Enhanced
handling of environment variables in DOS
commands. Better handling of ^Break when macro
playing is paused. Modified screen blanker to
allow portables to power down.
Version 1.5
Support for external commands and tools. All new
Picture mode/Line Draw mode. Automatic Project
File creation. New commands: Buffer Reload,
Tools Editclip, Goto Edit (New edit tracking
system). Multiple tags. New Wordprocessing and
WordWrap modes. Support for bright screen
background colours. More support for Novell
Netware. Template Macros. Enhanced Find Eol to
allow searching for Lone CR or LF at ends of
lines. Extended help system.
Version 1.0
First non-commercial release.
OVERVIEW *******************************************************
E4 will run on any PC compatible with 128K of RAM, under
MSDOS 3.0 or above, and any standard display adaptor. A
hard disk is not required: the minimum installation is
about 40K (42K for E4-Deluxe).
SVGA support allows for special text modes such as
100x40, 100x75 and 132x60, on those cards that offer it,
up to 255x255.
Full use is made of enhanced keyboards including F11 &
F12 and other special key combinations. Full mouse
support (for a true Microsoft compatible mouse) allows
on screen selection of text and menu operation. Note
that mouse support in SVGA screen modes often does not
work due to mouse driver limitations.
The editor occupies little disk space making it suitable
for installation on a RAM Disk, the optional help file
can be relocated elsewhere; using the E4HELP environment
variable.
E4 has a short start up time and loads and saves files
very quickly.
Most of the keys on the keyboard may be redefined to
suit you. Any standard key combination, or pair of keys,
may be assigned to one or more editor functions, simply
by editing a text file listing the assignments to be
made (E4KEYS). A command line switch can be used to
override customisation so that someone can use the
editor on another person's machine, for example when
giving help in a school or college.
The normal Cut and Paste system, which allows arbitrary
streams of characters to be moved about the editor, is
augmented by a simple system for moving and copying
whole lines, as this is such a common operation.
A design limitation is that the maximum file size that
may be edited is 64K, and is one reason the editor is so
small. This limit is offset somewhat by the ease with
which multiple files may be edited. In particular you
are able to perform a truly global search and replace
operation that affects several files. When programming
it is not a good idea to construct a program by using
one monolithic file, better to split it up into several
modules.
E4 comes with complete context-sensitive on-line help.
But you can use page-up and page-down to move through
the help screens one by one if you want to make sure you
see them all. Press F1 twice to find out how to use
help.
INSTALLATION & RUNNING *****************************************
DOS 3.0 or above is needed to run E4.
Copy the files listed in the packing list above to a
directory on your hard disk and put that directory in
your PATH. For example if you create a directory for the
editor called C:\E4 then you should add the following
line to your AUTOEXEC.BAT file (and reboot):
PATH C:\E4;%PATH%
If you have CED or ANARKEY or a similar command line
editor, you can have an alias that expands to the full
pathname of the editor, instead of adding the editor
directory to the PATH. E4 does not need to be in the
path to find its support files or programs.
Run the editor with the list of filenames you wish to
edit. Wildcards may be included:
E4 \AUTOEXEC.BAT \CONFIG.SYS \WINDOWS\*.INI
NOTE: A few systems may not correctly identify the type
of keyboard they have: if the editor hangs then reboot,
and run it again with the /P switch, which forces it to
use only the standard (PC) keyboard driver, rather than
the enhanced (AT) driver. Note that the editor has been
tested and does work correctly on true IBM PCs, IBM
PC/ATs and IBM PS/2s, as well as many machines from a
variety of manufacturers including Compaq, Dell, Grid,
NEC and Tandon.
The /B command line switch will run the editor in black
and white. /? will list other switches.
F1 displays context sensitive help.
Press ALT-Q to leave the editor.
You can put standard switch settings into the E4
environment variable:
SET E4=/B
The example above will cause the editor to always run in
Black and White.
You can have many options listed in the environment
variables. For example, if you also want to use CUA mode
(E4-Deluxe only) you would set the variable like this:
SET E4=/B /=CUA
These SET statements are best placed in your
AUTOEXEC.BAT file.
DEMO ***********************************************************
For a short demonstration of Resume Mode go to the root
directory of your boot disk and (assuming E4 is in your
PATH) type
E4 /R AUTOEXEC.BAT CONFIG.SYS
Then press ALT-Q to quit the editor.
Now whenever you want to edit your configuration simply
go to the root directory and type
E4
The cursor will be where it was and the same files will
be loaded. Any new files you load will also be available
to future sessions.
EXAMPLE APPLICATION - BORLAND PARADOX **************************
If you use Borland's Paradox (3.5 or 4.0) you can
install E4 as the default editor. Use the following
command line:
E4 /XSC * /**
This sets the default extension for loading and saving
to .SC (for script). Paradox replaces the * by the
filename and the ** by a line number within the file (E4
interprets a number after a slash as a line number to go
to on start up).
SUPPORT ********************************************************
Technical support is available directly from the author
by Post or E-Mail to any of the addresses given at the
foot of this document. E-mail is preferred.
Support is available whether or not you are a registered
user: We want you to be happy with E4 before you buy it.
ORDERING and PAYMENT *******************************************
This software has been made available so that potential
users may try it out before committing to buy it. If you
think that you have already paid for this software then
you have been mislead by whoever took your money. Many
organisations charge a copying fee for providing
evaluation copies of software like this, which is
legitimate within the limits detailed in the VENDOR.DOC
file. Others, who may also be charging a higher fee, do
not make it clear that you are paying them a service
charge for providing you with an evaluation copy of the
software.
You must pay for this software if you continue to use
it. This is copyrighted commercial software. The term
"Shareware" is often applied to software marketed in
this way, but it must not be confused with free software
such as that in the Public Domain (PD).
To pay for this software please examine the file
ORDER.DOC, which is a registration and order form. You
can fill this in before or after printing it out.
Alternatively any form of order may be used provided
that all the information requested in the text file is
provided. Always quote the issue number given on that
form (the same Issue Number appears in the editor banner
screen).
In exchange for payment you will receive a version of
the software without the registration reminders, and
which is registered to you personally. The price
includes both E4 and E4-Deluxe, a comprehensive printed
manual and extra utility programs and macros.
Note that this registered version may not be distributed
in any way and must be treated like any other commercial
program. Please refer to the licence agreements below.
EXTRAS *********************************************************
The following extra programs (at least) are shipped with
the registered version of the editor:
E4SM a program to set special text modes on VGA/EGA
cards. It also analyses your VGA card to find
out what special text modes are available.
E4TRAP a program to trap error output from a range of
compilers so that E4 can perform error tracking.
Currently supported compilers include Borland
C/C++, Turbo Pascal, Turbo Linker, Turbo
Assembler, Microsoft C, MASM, Fitted Software
Modula-2, Zortech C/C++ and others. Other
compilers will be added in the future.
Many compilers that are not listed will also
work, if they generate standard error messages.
Contact us if your compiler is not listed, we
will add it if necessary.
E4PRINT a program to print E4 wordwrap files (and
ordinary text files) on normal and PostScript
printers.
A library of useful programmer's macros is also
provided.
LICENCE AGREEMENTS *********************************************
"The software" refers in this case to the E4 editor and
any associated documentation and/or additional programs
or other items.
"The purchaser" is that person or organisation that pays
the fee for the software.
Licence for the Unregistered Version (this version) ************
This software is copyrighted and any duplication other
than under the terms of this agreement is a breach of
copyright law. You are given permission to duplicate the
software to give to others provided that you do not make
any changes to the software and that you distribute it
complete (preferably as the single self-extracting
archive file described above). You must not make a
charge for providing a copy of the software other than
within the limits detailed in the VENDOR.DOC file.
You are permitted to use the editor for a period not
exceeding 30 days beginning from the date of first use.
After this time you must pay if you wish to continue
using it, even if you intend to do so only infrequently.
If you do not purchase your own copy then you should
keep the software only in its archived (unusable) form
for the purposes of giving it to others.
Licences for the Commercial Version ****************************
This software is copyrighted and any duplication other
than under the terms of this agreement is a breach of
copyright law.
Payment of the registration fee gains for the purchaser
one or more disks and a licence to use the software
contained on those disks subject to the conditions
detailed below.
Single user Licence ************************************
The software provided upon payment of the
registration fee may not be duplicated other
than for the purposes of installing it on one or
more computers owned by the purchaser of the
software, and/or for a single "back-up" copy of
the supplied original disk or disks. The
purchaser may install the software on more than
one computer provided that there is no
possibility that more than a single copy of the
software be in use at any instant.
Network Licence ****************************************
Purchase of a network licence allows you to
install the software on a single file server
only (NOT a node in a peer-to-peer network). The
software may be used only by machines attached
to that network that are using that server. The
software may not be installed on any other
computer.
You must take all reasonable precautions to
prevent unauthorised copying. For example, for a
Novell network you must set the Execute Only
attribute for all executables that form part of
the software.
AFTERWORD and ADDRESSES ****************************************
Thank you for taking the time to wade through this file.
Please try out the program and send me your comments,
even if you choose not to continue using E4!
Author: UK Distributors:
Neil Faulks Business Consultants Ltd.
96 Middle Lane 37 York Road
Crouch End Woking
London Surrey
England England
N8 8NT GU22 7XN
E-mail: neil@dcs.kcl.ac.uk
CompuServe: >INTERNET:neil@dcs.kcl.ac.uk
[Note that my previous address of 28 Clickett Hill,
Basildon, Essex, SS14 1NW will also be valid for some
years to come, but I prefer post to be sent to the above
address]
End-of-File